home *** CD-ROM | disk | FTP | other *** search
/ PC World 2008 September / PCWorld_2008-09_cd.bin / domacnost a kancelar / notepad++ / npp.5.0.Installer.exe / plugins / doc / NppExec.txt < prev    next >
Text File  |  2008-02-14  |  9KB  |  192 lines
  1.  ****************************************************************************
  2.  * NppExec plugin ver. 0.2 RC3.2 for Notepad++ 4.3 (and above)
  3.  * by DV, December 2006 - July 2007
  4.  * by DV & Nicolas Babled & Geert Vancompernolle, July 2007 - February 2008
  5.  ****************************************************************************
  6.  *
  7.  * Possibilities:
  8.  *   1) Run multiple commands from the "Execute..." dialog
  9.  *   2) Run stand-alone command from the Console Dlg
  10.  *   3) Separate console for each NppExec.dll (e.g. NppExec1.dll, NppExec2.dll)
  11.  *   4) Additional commands:
  12.  *        cls - clear Console screen
  13.  *        cd - shows current path
  14.  *        cd <path> - changes current directory (absolute or relative)
  15.  *        cd <drive:\path> - changes current drive and directory
  16.  *        dir - lists subdirs and files
  17.  *        dir <mask> - lists subdirs and files matched the mask
  18.  *        dir <path\mask> - lists subdirs and files matched the mask
  19.  *        echo <text> - prints a text in the Console 
  20.  *        set - shows all user's variables
  21.  *        set <var> - shows the value of user's variable <var>
  22.  *        set <var> = <value> - sets the value of user's variable <var>
  23.  *        unset <var> - removes user's variable <var>
  24.  *        con_loadfrom <file> - loads a file's content to the Console
  25.  *        con_load <file> - see "con_loadfrom"
  26.  *        con_saveto <file> - saves the Console's content to a file
  27.  *        con_save - see "con_saveto"
  28.  *        npp_exec <script> - execute commands from specified script
  29.  *        npp_exec <file> - execute commands from specified file         (*)
  30.  *        npp_open <file> - open a file in Notepad++
  31.  *        npp_open <mask> - open files matched the mask
  32.  *        npp_open <path\mask> - open files matched the mask
  33.  *        npp_run <command> - run external process/command
  34.  *        npp_save - save current file in Notepad++
  35.  *        npp_save <file> - save a file in Notepad++ (if it's opened)    (*)
  36.  *        npp_saveall - save all modified files
  37.  *        npp_switch <file> - switch to specified opened file            (*)
  38.  *        (*) these commands work with a partial file path/name also
  39.  *            i.e.  npp_save c:\dir\f.txt  is the same as  npp_save f.txt
  40.  *   5) Additional console commands (Console Dlg only):
  41.  *        help       - show available commands
  42.  *        ver        - show plugin's version
  43.  *        CTRL+C     - terminate current child process
  44.  *        CTRL+BREAK - terminate current child process
  45.  *   6) All Notepad++ environment variables are supported:
  46.  *        $(FULL_CURRENT_PATH) : E:\my Web\main\welcome.html 
  47.  *        $(CURRENT_DIRECTORY) : E:\my Web\main
  48.  *        $(FILE_NAME)         : welcome.html 
  49.  *        $(NAME_PART)         : welcome 
  50.  *        $(EXT_PART)          : html
  51.  *        $(NPP_DIRECTORY)     : the full path of notepad++'s directory
  52.  *        $(CURRENT_WORD)      : word(s) you selected in Notepad++
  53.  *   7) Additional environment variables:
  54.  *        $(#0)                : C:\Program Files\Notepad++\notepad++.exe
  55.  *        $(#N), N=1,2,3...    : full path of the Nth opened document
  56.  *        $(LEFT_VIEW_FILE)    : current file path-name in primary (left) view
  57.  *        $(RIGHT_VIEW_FILE)   : current file path-name in second (right) view
  58.  *        $(ARGC)              : number of arguments passed to the NPP_EXEC command
  59.  *        $(ARGV)              : all arguments passed to the NPP_EXEC command after the script name
  60.  *        $(ARGV[0])           : script name - first parameter of the NPP_EXEC command
  61.  *        $(ARGV[N])           : Nth argument (N=1,2,3...)
  62.  *        $(RARGV)             : all arguments in reverse order (except the script name)
  63.  *        $(RARGV[N])          : Nth argument in reverse order (N=1,2,3...)
  64.  *        $(SYS.<var>)         : system's environment variable, e.g. $(SYS.PATH)
  65.  *
  66.  ****************************************************************************
  67.  
  68.  
  69.  *************
  70.  *  HISTORY  *
  71.  *************
  72.  
  73.  
  74.  v0.2 RC3.2 - February 2008
  75.  --------------------------
  76.  - fixed: NPP_RUN (ShellExecute) did not work with several arguments
  77.  
  78.  
  79.  v0.2 RC3.1 - February 2008
  80.  --------------------------
  81.  - fixed: buffer overflow in the Warning Analyzer
  82.  * changed: now NPP_RUN calls ShellExecute() instead of WinExec()
  83.  
  84.  
  85.  v0.2 RC3 - January 2008
  86.  -----------------------
  87.  + search in the Console
  88.  + history in the Console Filters dialog
  89.  + several issues fixed
  90.  + several cosmetic improvements
  91.  
  92.  
  93.  v0.2 RC2 - December 2007
  94.  ------------------------
  95.  + speeding up the console output
  96.  + watching for changes in "npes_saved.txt"
  97.  + TAB-key in the console auto-completes current command
  98.  + several cosmetic improvements
  99.  
  100.  
  101.  v0.2 RC1 - December 2007
  102.  ------------------------
  103.  1. A lot of internal changes/improvements.
  104.  In particular, now all plugin's options are stored, read and written by the
  105.  Options Manager component.
  106.  The Warning Analyzer component, developed by Nicolas Babled, allows to filter
  107.  and recognize different compiler/interpretter error and warning messages - and
  108.  extract useful information from these messages (such as file name and line 
  109.  number).
  110.  The Simple Logger component stores detailed information about last executed
  111.  command (can be usefull for "debugging").
  112.  * The console redirecting engine has been improved.
  113.  * Now the plugin identifies itself by its dll-file name. Each copy of the 
  114.  plugin (each dll-file) stores its options in corresponding ini-file.
  115.  * Now plugin's environment variables (e.g. "$(FILE_NAME)") are available for
  116.  child console process. For example, start "cmd.exe" and type "echo $(#1)".
  117.  * Now system's environment variables are available in a form of "$(SYS.<var>)"
  118.  e.g. "$(SYS.WINDIR)", "$(SYS.TEMP)" etc.
  119.  * Now the NPP_EXEC command can pass arguments to the script. These arguments 
  120.  can be accessed in the script through the following macro-variables:
  121.  $(ARGC), $(ARGV), $(ARGV[n]).
  122.  Example:  npp_exec "script name" param_1 "param 2".
  123.  This example sets the following values for the script:
  124.  $(ARGC) = 3;  $(ARGV) = param_1 "param 2";  $(ARGV[0]) = script name;
  125.  $(ARGV[1]) = param_1;  $(ARGV[2]) = param 2.
  126.  * Each command now have detailed help information. Type "help" or "help help" 
  127.  in the NppExec's Console.
  128.  * Now the console commands history is restored when you restart Notepad++.
  129.  
  130.  2. New menu items:
  131.  Direct Execute Previous - directly executes previous script.
  132.  No internal messages - do not show such messages as "Process started >>>", etc.
  133.  Save all files on execute - saves all files before executing a script.
  134.  Also NppExec's toolbar icon has been added.
  135.  
  136.  3. New dialog:  Console Output Filter -> Highlight.
  137.  This dialog allows you to specify a string mask for compiler/interpretter error 
  138.  and warning messages with such keywords as %FILE%, %ABSFILE% and %LINE%.
  139.  These messages can be highlighted with different colours and allow you to go
  140.  to certain line in certain file when double-clicked in the Console window.
  141.  
  142.  4. New messages:
  143.  NPP_SAVEALL - saves all modified files.
  144.  CON_LOADFROM - loads a file's content to the Console.
  145.  CON_SAVETO - saves the Console's content to a file.
  146.  ECHO - prints a text in the Console (supports internal env. variables)
  147.  SET - sets the value of user's variable
  148.  UNSET - removes user's variable
  149.  
  150.  
  151.  v0.2 beta4 - July 2007
  152.  ----------------------
  153.  - fixed: buffer size was not checked before calling OemToChar() 
  154.  - fixed/added: '\b' and '\r' handling
  155.  + a lot of changes in plugin's internals (basic cpp-classes and NppExecEngine)
  156.  + new command: cd, cd <path>, cd <drive:\path>
  157.  + new command: dir, dir <mask>, dir <path\mask>
  158.  + new feature: npp_open <mask>, npp_open <path\mask>
  159.  + new environment variables: $(LEFT_VIEW_FILE) and $(RIGHT_VIEW_FILE)
  160.  * thanks to all who wait for this version
  161.  
  162.  
  163.  v0.2 beta3 - April 2007
  164.  -----------------------
  165.  - fixed: Delete button (Script name dialog) was not enabled sometimes
  166.  + Menu: Show Console Dialog
  167.  + Console Output Filter: Exclude all empty lines
  168.  + Comment delimiter can be user-defined, // in :// is no more comment
  169.  
  170.  
  171.  v0.2 beta2 - March 2007
  172.  -----------------------
  173.  + Menu: Console Commands History.
  174.      When enabled, previous commands can be scrolled by pressing 
  175.      arrow keys Up and Down.
  176.  + Menu: Console Output Filter.
  177.      When enabled, output messages from running console process
  178.      can be filtered (i.e. particular lines can be excluded)
  179.  - ConsoleDlg: Ctrl+A is unlocked
  180.  - ConsoleDlg: Quotes "" are no more added automatically for paths
  181.      with spaces (because of a bug with executables w/o extension
  182.      such as "cmd /c calc.exe")
  183.  - Several internal fixes
  184.  - Several additional internal fixes :-)
  185.  * Thanks to Jim Granville for his suggestions
  186.       
  187.  
  188.  v0.1 - March 2007
  189.  -----------------
  190.  * initial version
  191.  
  192.